home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / prgtools / pcshel25.zip / PCSHELL.DOC < prev    next >
Text File  |  1995-01-09  |  32KB  |  991 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         
  8.                             
  9.                             
  10.                             
  11.                             
  12.                             
  13.                             
  14.                             
  15.                             
  16.                             
  17.                             
  18.                             
  19.                             _______
  20.                        ____|__     |               (TM)
  21.                     --|       |    |-------------------
  22.                       |   ____|__  |  Association of
  23.                       |  |       |_|  Shareware
  24.                       |__|   o   |    Professionals
  25.                     -----|   |   |---------------------
  26.                          |___|___|    MEMBER
  27.         
  28.         
  29.                               POWER C SHELL
  30.                                VERSION 2.5
  31.                               
  32.         Copyright 1991-1995 by Chuck Steenburgh & Tay-Jee Software
  33.          
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                                      Page 1
  57.  
  58.  
  59.  
  60.  
  61.  
  62.         
  63.         
  64.         
  65.         
  66.                           TABLE OF CONTENTS
  67.         
  68.         Definition of Shareware .  .  .  .  .  .  .  .  .  .  3
  69.         
  70.         Distribution Limitations.  .  .  .  .  .  .  .  .  .  3
  71.         
  72.         ASP Ombudsman  .  .  .  .  .  .  .  .  .  .  .  .  .  3
  73.         
  74.         Disclaimer  .  .  .  .  .  .  .  .  .  .  .  .  .  .  3
  75.         
  76.         Starting Power C Shell Version 2.5  .  .  .  .  .  .  6
  77.         
  78.            Running Power C Shell                              6
  79.            Configuring PCS                                    6
  80.            Installing PCS                                     7
  81.         
  82.         Power C Shell Display.  .  .  .  .  .  .  .  .  .  .  8
  83.         
  84.         Power C Shell Menu Options .  .  .  .  .  .  .  .  .  9
  85.         
  86.            Files Menu                                         9
  87.            Operations Menu                                   10
  88.            Configuration Menu                                12
  89.            Quit Menu                                         13
  90.         
  91.         Appendices  .  .  .  .  .  .  .  .  .  .  .  .  .  . 14
  92.         
  93.            Environment variables                             14 
  94.            Help                                              15
  95.          
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.                                      Page 2
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                     
  118.         DEFINITION OF SHAREWARE
  119.         
  120.         Shareware distribution gives users a chance to try software
  121.         before buying it. If you try a Shareware program and continue
  122.         using it, you are expected to register. Individual programs
  123.         differ on details -- some request registration while others
  124.         require it, some specify a maximum trial period. With
  125.         registration, you get anything from the simple right to continue
  126.         using the software to an updated program with printed manual.
  127.         
  128.         Copyright laws apply to both Shareware and commercial software,
  129.         and the copyright holder retains all rights, with a few specific
  130.         exceptions as stated below. Shareware authors are accomplished
  131.         programmers, just like commercial authors, and the programs are
  132.         of comparable quality. (In both cases, there are good programs
  133.         and bad ones!) The main difference is in the method of
  134.         distribution. The author specifically grants the right to copy
  135.         and distribute the software, either to all and sundry or to a
  136.         specific group. For example, some authors require written
  137.         permission before a commercial disk vendor may copy their
  138.         Shareware.
  139.         
  140.         Shareware is a distribution method, not a type of software. You
  141.         should find software that suits your needs and pocketbook,
  142.         whether it's commercial or Shareware. The Shareware system makes
  143.         fitting your needs easier, because you can try before you buy.
  144.         And because the overhead is low, prices are low also. Shareware
  145.         has the ultimate money-back guarantee -- if you don't use the
  146.         product, you don't pay for it.
  147.         
  148.         DISTRIBUTION LIMITATIONS:  This is a copyrighted shareware
  149.         program.  You have a limited license to try out this soft-
  150.         ware on a single computer for a period of 30 days.  If you
  151.         continue to use the software after this 30-day trial period,
  152.         you must become a registered user.
  153.         
  154.         OMBUDSMAN
  155.         
  156.           This program is produced by a member of the Association of
  157.         Shareware Professionals (ASP).  ASP wants to make sure that
  158.         the shareware principle works for you.  If you are unable to
  159.         resolve a shareware-related problem with an ASP member by
  160.         contacting the member directly, ASP may be able to help.  The
  161.         ASP Ombudsman can help you resolve a dispute or problem with
  162.         an ASP member, but does not provide technical support for 
  163.         members' products.  Please write to the ASP Ombudsman at 545
  164.         Grover Road, Muskegon, MI 49442 or send a CompuServe message
  165.  
  166.                                      Page 3
  167.  
  168.  
  169.  
  170.  
  171.  
  172.         via CompuServe Mail to ASP Ombudsman, 70007,3536.
  173.         
  174.         DISCLAIMER
  175.         
  176.            The program described in this documentation is guaranteed 
  177.         to do absolutely nothing!  It has, however, in my experience
  178.         performed essentially as described herein.  The author will 
  179.         not be responsible for any loss or damages caused through
  180.         the use of these programs.  No warranty, express or implied,
  181.         is provided for this software's performance, merchantability,
  182.         or fitness for a particular purpose.
  183.         
  184.            All trademarks are property of their respective owners.  In
  185.         particular, "Power C" is a registered trademark of MIX Software.
  186.         
  187.            The program and documentation are Copyright 1991-193 by Chuck
  188.         Steenburgh & Tay-Jee Software.  You are encouraged to distribute
  189.         these programs provided the conditions specified in the
  190.         VENDOR.DOC file are met.
  191.         
  192.            You may evaluate this program for up to 30 days on a free
  193.         trial basis.  After 30 days, you should register your use of
  194.         the program.  The registration fee is $19.95, payable to Tay-Jee
  195.         Software at the address given below.  Please see the file
  196.         REGISTER.FRM on the distribution disk/archive.
  197.         
  198.            Registration does have its advantages:
  199.         
  200.            - We are improving the program all the time.  Registration
  201.              will get you IMMEDIATELY a disk with the latest version.
  202.         
  203.            - You will receive a free copy of Chuck Steenburgh's per-
  204.              sonal 'C' function library - more than two dozen useful
  205.              additions to your Power C programming library.
  206.         
  207.            - While we can't promise to include everyone's suggestions
  208.              in program updates, you can bet we'll listen to registered
  209.              users before any of you scrounges out there.
  210.         
  211.            - You will also get evaluation copies of our other shareware
  212.              products, including:
  213.                   * STEENBURGH's STUFF batch file utilities
  214.                   * BACK SOON! intelligent screen saver
  215.                   * 6th SENSE utilities for DOS 6.00
  216.                   * MARGARINE easy text file formatting utility
  217.            
  218.            - Registered users can obtain the source code for the program
  219.              at the cost of an additional $10.
  220.  
  221.                                      Page 4
  222.  
  223.  
  224.  
  225.  
  226.  
  227.         
  228.            Send comments/registrations to:
  229.         
  230.                 Tay-Jee Software
  231.                 Post Office Box 835
  232.                 Lexington, VA 24450
  233.                 (703)261-5290
  234.                 
  235.                 !!!VIRGINIA RESIDENTS ADD 4.5SALES TAX!!!
  236.                 
  237.                 Orders outside North America add $5 shipping.  Payment
  238.                 must be made in U.S. funds, but non-U.S. checks are OK.
  239.                 
  240.                 On-line registration: CompuServe (GO SWREG), #1180.
  241.                 (Use #1218 for source code version.)
  242.         
  243.                 CIS 72330,1776 (we haunt the IBMSYS and IBMPRO forums)
  244.         
  245.         Now that the semi-legal mumbo-jumbo is out of the way, welcome
  246.         to POWER C SHELL Version 2.5.  This program began as a simple 
  247.         aid to Power C programmers and blossomed into a much more am-
  248.         bitious project.  POWER C SHELL Version 2.5 has the following 
  249.         features:
  250.         
  251.              - Simplifies editing, compiling, and debugging
  252.              of POWER C programs without having to fool with
  253.              the DOS command line
  254.             
  255.              - Customizable editor and viewer (use your favorites),
  256.              or use the very handy TDE public domain editor in-
  257.              cluded in the package
  258.             
  259.              - Customizable compile & link options for Power C 
  260.              compiler (with help screens to explain them all)
  261.              
  262.              - Interface includes support of Power C Trace inter-
  263.              active debugging utility, available separately from
  264.              Mix Software.
  265.             
  266.              - Ability to review C.ERR error listing without
  267.              leaving the shell
  268.             
  269.              - Test run your executable programs without
  270.              leaving the shell
  271.              
  272.              - Easy, one-step loading of complete projects
  273.              
  274.              - Customizable screen colors
  275.  
  276.                                      Page 5
  277.  
  278.  
  279.  
  280.  
  281.  
  282.              
  283.              - Context-sensitive help (although the program is so
  284.              simple, I doubt you'll need it)
  285.              
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.                                      Page 6
  332.  
  333.  
  334.  
  335.  
  336.  
  337.         STARTING POWER C SHELL VERSION 2.5
  338.         
  339.            Power C Shell itself requires approximately 145K of free
  340.         memory to run.  To this amount, however, you must add the 
  341.         greater of the memory required by your editor, viewer, and 
  342.         whatever C program you happen to be working on.  Power C Shell
  343.         remains in memory when these programs are executing.  The
  344.         Power C compiler, version 2.x, requires about 256K of free
  345.         memory.  Basically, a 512K machine or better is a safe bet, al-
  346.         though you might get by with only 384K available.  If you wish
  347.         to use Power C Trace with Power C Shell, you will need much more
  348.         available memory: 150k for Power C Trace, 145k for Power C
  349.         Shell, and whatever memory is required the program which you are
  350.         working on.
  351.         
  352.             
  353.              Running Power C Shell
  354.              =====================
  355.             
  356.              The syntax for starting Power C Shell is as follows:
  357.             
  358.                PCS2 [filename] [/D-] [/Llibname] [/H]
  359.                
  360.                [filename] optional parameter specifying complete
  361.                           name of source file to work on
  362.                
  363.                [/D-]      optional parameter telling PCS to ignore its
  364.                           configured starting directory and use the
  365.                           current directory
  366.                
  367.                [/L]       specify additional function library (switch
  368.                           must be followed by complete library name)
  369.                
  370.                [/H]       display a brief help screen
  371.              
  372.         
  373.         
  374.              Configuring PCS
  375.              =========== ===
  376.              
  377.            Prior to using PCS, you will have to configure it.  You may
  378.         do this either through the environment variables described in
  379.         the appendices or through the Configuration pull-down menu 
  380.         detailed below.  At a minimum, you will need to specify the 
  381.         name of your editor and any compile options you would like used 
  382.         with the Power C.  You may also want to specify the name of a
  383.         text viewer - a program which allows you to view the contents
  384.         of an ASCII file - with which to examine the C.ERR file.  (You
  385.  
  386.                                      Page 7
  387.  
  388.  
  389.  
  390.  
  391.  
  392.         may use the editor for this purpose as well.)
  393.         
  394.                
  395.         
  396.         
  397.         
  398.              Installing PCS
  399.              ========== ===
  400.            
  401.            It is recommended, but not necessary, to copy the PCS2.EXE
  402.         program file to the same directory containing your Power C com-
  403.         piler.  If you would like to be able to use PCS from any direc-
  404.         tory, make sure the PCS2.EXE file is placed in a subdirectory
  405.         contained in your DOS PATH.
  406.         
  407.            If you would like to use the TDE editor with PCS, place the
  408.         TDE program files in a directory accessible to PCS.  If this
  409.         directory is not also on your DOS PATH, you will have to specify
  410.         the COMPLETE path for TDE when you configure PCS.
  411.          
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.                                      Page 8
  442.  
  443.  
  444.  
  445.  
  446.  
  447.         
  448.         POWER C SHELL DISPLAY
  449.         
  450.              Project Board
  451.              
  452.            The main display is divided up into three areas.  The largest
  453.         area, in the upper left portion of the screen, is the "project
  454.         board" which lists information regarding the current project
  455.         being worked on.
  456.         
  457.            Space here is used to list all currently open source files
  458.         (up to seven), the name of the project make file, the name of
  459.         the executable file being linked to, the current working dir-
  460.         ectory, the name of any object library specified, and the name
  461.         of the project include file.
  462.         
  463.              
  464.              Memory Management Display
  465.              
  466.            To the right of the "project board" is the memory management
  467.         display, showing current allocations of stack, heap, and far
  468.         heap memory.
  469.         
  470.         
  471.              Status Board
  472.            
  473.            In the bottom area of the screen is the "status board."  This
  474.         area is used to display current Power C Shell settings such as
  475.         the name of the editor and viewer and their switches, and any
  476.         command line switches in effect for the Power C compiler, link-
  477.         er, and trace program.
  478.         
  479.         
  480.              Other Display Features
  481.            
  482.            The bottom line of the display is used by the passive help
  483.         system (described below) and a copyright message.  The top line
  484.         of the display contains the pull-down menu bar and a real-time
  485.         24-hour clock.
  486.          
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.                                      Page 9
  497.  
  498.  
  499.  
  500.  
  501.  
  502.         
  503.         POWER C SHELL MENU OPTIONS
  504.         
  505.              Files Menu
  506.              ===== ====
  507.         
  508.            Pressing the Alt-F key combination will activate the Files
  509.         pull-down menu, which contains the following options:            
  510.         
  511.         
  512.              Open 
  513.              
  514.            Selecting this menu choice will allow you to open a file for
  515.         editing and/or compiling.  Up to seven files, all belonging to
  516.         the same project, may be open at one time in PCS v2.5.  After
  517.         selecting this item, you'll be asked to enter a wildcard file
  518.         specification.  The default is *.C; however, you may enter any
  519.         value you like.  A list of all files matching the entered wild-
  520.         card pattern will be displayed in a box centered on the screen.
  521.         Using the cursor keys, position the highlight bar over the name
  522.         of the file you would like to open and then press <Enter>.
  523.         
  524.            If you open a Power C project file with a .PRJ extension, all
  525.         of the associated source files of the project will be opened.
  526.         NOTE:  This project file MUST be in PCS 2.5 format for this to
  527.         work properly.  If you open a project file while other files are
  528.         open, they will be closed first and then the project will be
  529.         loaded.
  530.         
  531.            If more than one file is open, you will be asked to choose an
  532.         "active file."  The active file is the file which is loaded by
  533.         the "Edit" menu choice described below.  Enter the file number
  534.         (1-7) of the file which you would like to be active.  A pair
  535.         of flashing exclamation points appears next to the name of the 
  536.         active file.
  537.         
  538.         
  539.              New file
  540.              
  541.            Selecting this menu item will allow you to type the name of a
  542.         new C source file on upon which to begin work.  Do NOT enter the
  543.         name of a project (*.PRJ) file.  Again, if multiple files are
  544.         open, you will be asked to select the active file.
  545.         
  546.         
  547.              Switch
  548.            
  549.            Selecting this item will allow you to change the active file.
  550.  
  551.                                      Page 10
  552.  
  553.  
  554.  
  555.  
  556.  
  557.             
  558.         
  559.              Edit
  560.             
  561.            Selecting this menu item will invoke your editor and load the
  562.         currently active file for editing.
  563.         
  564.         
  565.              Close
  566.            
  567.            This option allows you to remove a file from the list of
  568.         open source files.  Type the number of the file you wish to
  569.         close in the dialog box.  If more than one file remains open,
  570.         you will be asked to designate a new active file.
  571.         
  572.         
  573.              All Close
  574.            
  575.            This option will remove ALL files from the open list.
  576.            
  577.            
  578.              Print
  579.            
  580.            This option allows you to print one or more files associated
  581.         with the current project.  In the dialog box that appears, press
  582.         "A" to print all source files, "I" to print the project #include
  583.         file (*.H), or the number of a single open file.  Your printer
  584.         must be connected to the standard printer port (usually LPT1).  |
  585.         
  586.            If there is an error, PCS will inform you of the nature of the
  587.         problem and provide you with the opportunity of correcting it or
  588.         aborting the print operation.
  589.         
  590.         
  591.              Directory
  592.            
  593.            This option allows you to change the current working direc-
  594.         tory.  Enter a drive letter, directory, or complete path, as
  595.         appropriate, into the dialog box.  Any open files will be closed
  596.         upon changing directories.
  597.         
  598.         
  599.              Info                                                       |
  600.            
  601.            Selecting this item calls up a dialog box displaying the pro-|
  602.         gram version and other information.  In the unregistered version|
  603.         you may also print a registration form from this screen.        |
  604.         
  605.  
  606.                                      Page 11
  607.  
  608.  
  609.  
  610.  
  611.  
  612.         
  613.              Operations Menu
  614.              ========== ====
  615.              
  616.            Pressing the Alt-O key combination activates the Operations
  617.         pull-down menu, which contains the following options:
  618.         
  619.         
  620.              Compile
  621.            
  622.            Selecting this item invokes the Power C compiler and compiles
  623.         the currently open source file(s).  Any compile options speci-
  624.         fied through the PCS configuration file or environment variables
  625.         will eb in effect for the compilation.
  626.         
  627.            The compile listing will appear on the screen and you will
  628.         have the opportunity to view it prior to return to PCS.  To pre-
  629.         vent the listing from scrolling off the screen, include the
  630.         #pragma pagesize preprocessor directive in your program source.
  631.         
  632.         
  633.              Link
  634.            
  635.            The current project or source file will be linked, using the
  636.         options specified through the configuration file or environment
  637.         variable.  The executable file produced will have the same name
  638.         as the first open file, with the extension .EXE.
  639.         
  640.         
  641.              Header
  642.              
  643.            Selecting this option will invoke your editor and load the
  644.         project #include (*.H) file.  Using such a file is an easy way
  645.         to declare external variables by using the #include file in
  646.         supplementary project source code modules.
  647.         
  648.         
  649.              View C.ERR
  650.              
  651.            This option will invoke your viewer and allow you to see the
  652.         contents of the most recent compile listing (contained in the
  653.         C.ERR file generated by PC.EXE).
  654.         
  655.         
  656.              Trace
  657.            
  658.            Selecting this menu item will invoke Power C Trace, a program
  659.         available separately from Mix Software.  The PCT.EXE program
  660.  
  661.                                      Page 12
  662.  
  663.  
  664.  
  665.  
  666.  
  667.         must be located in a directory on the DOS PATH, or in the cur-
  668.         rent directory.  You should also have compiled your program with
  669.         the /T switch, and subsequently linked it, prior to running the
  670.         trace program.
  671.         
  672.         
  673.              DOS Shell
  674.            
  675.            This option allows you to return momentarily to the DOS com-
  676.         mand line without exiting PCS 2.5.  A reminder will appear in
  677.         your prompt informing you to type "exit" to return to PCS.  
  678.         While you are in the DOS Shell, keep in mind that your total
  679.         free memory is reduced by approximately 140k.
  680.         
  681.         
  682.         
  683.         
  684.         
  685.              Configuration Menu
  686.              ============= ====
  687.              
  688.            Pressing the Alt-C key combination will activate the Con-
  689.         figuration pull-down menu, which includes the following op-
  690.         tions:
  691.         
  692.         
  693.              Editor
  694.            
  695.            Selecting this option will allow you to enter the name of
  696.         your editor.  In the first dialog box, enter the complete path
  697.         and file name of your editor program.  In the second dialog box,
  698.         enter any command line parameters (switches) required by your
  699.         editor, if any.  A third dialog box will ask if your editor can
  700.         load more than one file from the command line.  If your editor
  701.         can accept multiple file names, press "Y"; otherwise, press "N".
  702.         The editor name and switches will then appear on the appropriate 
  703.         line in the status area at the bottom of the screen.
  704.         
  705.         
  706.              Viewer
  707.            
  708.            This option allows you to configure your viewer program.
  709.         Follow the steps above for the editor, this time typing the
  710.         path and switches for the viewer.  The viewer is used only for
  711.         viewing the contents of the C.ERR file from within Power C
  712.         Shell.
  713.         
  714.         
  715.  
  716.                                      Page 13
  717.  
  718.  
  719.  
  720.  
  721.  
  722.              Compile Options
  723.              
  724.            This option will allow you to select which switches are to be
  725.         used by the Power C compiler.  The PC.EXE file's help screen 
  726.         will be displayed and a small dialog box will appear at the bot-
  727.         tom of the screen.  Enter your choice into the box.
  728.         
  729.         
  730.              Link Options
  731.            
  732.            This menu choice will allow you to specify link options.  A
  733.         small help screen explaining the available switches will be
  734.         presented.  Enter your switch(es) in the dialog box.
  735.         
  736.         
  737.              Memory Allocations
  738.              
  739.            With this option you can control the size of the stack, heap,
  740.         and far heap of your program.  Enter values for each of these
  741.         items in the dialog box just as you would enter them on the com-
  742.         mand line.  For example, if you want 16k of memory for the stack
  743.         enter "16k"; if you want 800 bytes allocated for the heap, enter
  744.         "800."
  745.         
  746.         
  747.              Object Library
  748.            
  749.            Select this option to enter the name of an object file to be
  750.         linked as a library.  This can be a library of your own creation
  751.         or a third-party library.  Make use of the "?" wildcard to spec-
  752.         ify different library names for the three memory models.  For
  753.         example, PCS is linked with the library CJSLIBM.MIX, a library
  754.         of functions developed by Tay-Jee Software.  By entering the
  755.         name "CJSLIB?.MIX" as an object library, the files CJSLIBS.MIX,
  756.         CJSLIBM.MIX, or CJSLIBL.MIX will be linked depending upon which
  757.         memory model is in effect.  (See the Power C README file for a
  758.         further discussion of libraries and wildcards.)
  759.         
  760.         
  761.              Trace Options
  762.            
  763.            This option allows you to specify command line arguments for
  764.         Power C Trace.  A brief desctiption of the available switches is
  765.         shown in the dialog box; simply type the switch(es) you wish to
  766.         have included on the command line when you use Power C Trace.
  767.         
  768.         
  769.              Program Colors
  770.  
  771.                                      Page 14
  772.  
  773.  
  774.  
  775.  
  776.  
  777.            
  778.            Selecting this option activates the program color selection
  779.         process.  Nine screen elements can have their screen attributes
  780.         individually configured.  Enter the number of the screen color
  781.         you wish to modify, then position the flashing star character
  782.         over the appropriate color combination, then press <Enter>.
  783.         Once you are through selecting colors, press ESC instead of a   |
  784.         color number.  In the dialog box which appears, type U to put   |
  785.         your newly selected colors into effect, C to ignore the new     |
  786.         colors and use the colors in currently in effect, or D to
  787.         revert to the program's default color scheme.  In the unreg-
  788.         istered version, while you can change the colors selected, you
  789.         cannot save these changes in the configuration file.
  790.         
  791.         
  792.              Quit
  793.              ====
  794.             
  795.            Select this option to leave Power C Shell and return to 
  796.         DOS.  Three options are available:  "Yes" exits PCS immediately;
  797.         "Save" updates the PCSHELL.CFG file with the current settings,
  798.         then returns to DOS; and "No" returns you to PCS.
  799.          
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.                                      Page 15
  827.  
  828.  
  829.  
  830.  
  831.  
  832.         
  833.         APPENDICES
  834.         
  835.             Environment Variables
  836.             =====================
  837.             
  838.            Power C Shell can configure itself through the use of
  839.         environment variables. Power C Shell understands the following
  840.         environment variables:
  841.         
  842.              PCEDIT:     complete path of your editor
  843.              PCEDITP:    any command line parameters used by your editor
  844.              PCVIEW:     complete path of your viewer
  845.              PCVIEWP:    any command line parameters used by your viewer
  846.              PCOPTIONS:  default compile options to be used by PC.EXE
  847.              PCLINK:     default link options to be used by PCL.EXE
  848.              PCTRACE:    default options to be used by PCT.EXE
  849.             
  850.            Environment variables are established by use of the DOS
  851.         SET command.  To set the name of your viewer to C:\LIST.COM,
  852.         simply type the following at the DOS command line:
  853.         
  854.              SET PCVIEW=C:\LIST.COM
  855.             
  856.            Use a similar procedure to set the other variables.  To
  857.         set your default compile options to "/e/ms" (link file, use
  858.         small memory model), type the following on the DOS command 
  859.         line:
  860.         
  861.              SET PCOPTIONS=/e/ms
  862.             
  863.            If, while entering your environment variables, you get
  864.         the message "Out of environment space" or something similar,
  865.         you need to edit your CONFIG.SYS file.  Look for a state-
  866.         ment similar to the following:
  867.         
  868.              SHELL=c:\dos\command.com c:\dos /p
  869.             
  870.            To increase the environment space, change the statement
  871.         to something like this:
  872.         
  873.              SHELL=c:\dos\command.com c:\dos /p /e:384
  874.             
  875.            In the example above, 384 is the new number of bytes re-
  876.         served for the environment (160 is the default).  DOS will 
  877.         always round this number to a multiple of 16.  384 bytes 
  878.         should be enough for most users, although you may need more.
  879.         The limit is 32,768, although there should never be a need 
  880.  
  881.                                      Page 16
  882.  
  883.  
  884.  
  885.  
  886.  
  887.         for more than 1 or 2K.   See your DOS manual for more de-
  888.         tails on setting the environment size.  Note that you must 
  889.         reboot your computer after editing your CONFIG.SYS file for
  890.         any changes to take effect.
  891.         
  892.            The PCEDITP and PCVIEWP parameter variables assume that
  893.         your editor and viewer accept command line switches AFTER the 
  894.         filename to edit/view.  For example:
  895.         
  896.              <PCEDIT> (filename) <PCEDITP>
  897.              edit   program.c   -x -e
  898.               
  899.            If your editor/viewer only accept parameters and switches
  900.         BEFORE the filename, enter them as part of the PCEDIT or 
  901.         PCVIEW varaibles.  For example:
  902.         
  903.              <PCEDIT>     (filename)
  904.              edit -x -e   program.c
  905.             
  906.            you would enter the following command on the DOS command 
  907.         line prior to starting Power C Shell:
  908.         
  909.              SET PCEDIT=edit -x -e
  910.         
  911.            Environment variables will override any options contained
  912.         in the PCSHELL.CFG configuration file.
  913.         
  914.              Help
  915.              ====
  916.         
  917.            Context-sensitive help is available from within the PCS
  918.         menu system (only).  From the main PCS screen, or from within
  919.         any pull-down menu, pressing <F1> activates the help system.
  920.         A box will appear on the middle of the screen containing the
  921.         help information for the currently selected menu operation.
  922.         Use the cursor movement keys to scroll the help text up and
  923.         down through the box.  Pressing <Esc> returns you to PCS.
  924.         
  925.            A passive help system also exists for all menu items.  Look
  926.         at the bottom line on the screen for a brief description of the
  927.         currently highlighted menu item.
  928.         
  929.            A short help line appears for most dialog boxes in PCS.  Most 
  930.         "basic" editing functions, such as Insert/Delete and Backspace 
  931.         work normally in dialog boxes.  In addition, the <Tab> key can 
  932.         be used to DELETE all information in a dialog box which lies to 
  933.         the right of the cursor.
  934.         
  935.  
  936.                                      Page 17
  937.  
  938.  
  939.  
  940.  
  941.  
  942.         
  943.              Shortcut Keys
  944.              =============
  945.              
  946.            Shortcut keys have been provided for most menu options.  The |
  947.         function keys (F2-F10) provide shortcuts for the File pull-down |
  948.         menu.  The function keys, in conjunction with the Alt- and Ctrl-|
  949.         keys, respectively, provide shortcuts for the Operations and    |
  950.         Configuration pull-down menus.  Press the ? key to display a    |
  951.         table listing the shortcut keys.                                |
  952.         
  953.         
  954.         
  955.            This document was formatted with MARGARINE 3.2, a utility 
  956.         program created using Power C 2.2.0 and Power C Shell.  Look for
  957.         it in IBM Systems/Utilities Forum (IBMSYS) on CompuServe (found
  958.         in the New Uploads or General Utilities Library as MARGAR.ZIP).
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.                                      Page 18